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Verses added to a golden oldie 

At the very core of every Apple II ever built from the first Integer Basic 
model to the Ilgs, you'll find something called the System Monitor. This built- 
in software allows you to examine and control the Apple II at a very intimate 
level. Citizens of other computer kingdoms, who don't have similar 
programs built into their computers, will tell you the Apple Monitor has little 
significance— they'll say only assembly language high priests can use it In 
fact, just the opposite is true. 

The significant thing about the Apple Monitor is that it has lured tens of 
thousands of mere mortals into learning how the Apple II works. There are no 
secrets in our kingdom (it's a tradition handed down from Woz) and there are 
no high priests. The Monitor is one of the major tools used by laypeople to 
learn how to release the power of the Apple II. Likewise, it is this body of 
thousands of laypeople who have learned how to release the Apple I I's power 
that make the Apple II different from the machines at the center of other 
kingdoms. 

Being one of the mere mortals myself (computer high priests rarely accept 
English majors as one of their own). I've always had a great deal of respect for 
the Monitor. Way back at the beginning of Open-Apple's Volume 1 you'll find 
two articles, "A Song Called the System Monitor" (February 1985, pages 19- 
112) and "A Song Continued" (March 1985, pages 120-121), that were 
written to introduce the Monitor to those of you who had never used it The 
articles describe the Monitor as it exists on the original Apple II, the II-Plus, 
the lie, the lie, and the enhanced He. 

This month we're going to summarize what was explained in detail in 
those issues and we're going to take a closer look at the Monitor as it exists 
on the new Apple Ilgs. The Monitor changed hardly at all between the original 
Apple II and the enhanced lie, even though the machines themselves 
progressed through several revisions. For example, the memory capacity of 
the machines grew from 48K to 64K to 128K, but the memory-examining 
capacity of the Monitor never grew beyond the original 48K. 

Apple has fixed all this in the Ilgs, however. The Ilgs Monitor has been 
enhanced with new powers and new commands. On the Ilgs you can 
examine and manipulate memory in the "language cards" and in the 
"auxiliary bank" as easily as any other memory. In addition, you'll find 
memory displays that can take advantage of 80-column screens and show 
ASCII values, commands for converting numbers back and forth between 
hex and decimal, and several commands that support new features of the 
Ilgs. 

Entering the Monitor. The usual way of entering the Monitor is from 
Applesoft with a CALL -151 command. The entry point of the machine 
language program that is the Monitor starts at $FF69, which is equivalent to 
-151 in decimal (or 65385, take your pick). 

Another way to get into the Monitor is to get the microprocessor to execute 
a BRK (break) command. The microprocessor will do this whenever it 
encounters a zero (the machine code for BRK) as it is executing a machine 
language program. Most users think of this as "crashing into the Monitor." 
When the program you are using beeps, puts an asterisk on the screen, and 
displays a new row of letters and numbers every time you press return, this is 
what has happened to you. Unless you have a Ilgs, you'll see a line that looks 
something like this somewhere on your screen: 

0B02- fl=0B X=15 Y=25 P=30 S=E4 

On a Ilgs, the line looks more like this: 

00/0B00: 00 00 BRK 00 

fi=000B X=0015 Y=0025 5=01E4 0=0000 P=30 B=00 l<=00 M=0C 0=00 L=1 m=l x=l e=l 


Machine language programmers use BRK for debugging purposes. A BRK 
stops a program at a spot selected by the programmer and allows 
examination of the microprocessor's memory registers and the computer's 
memory. When a commercial program executes a BRK and crashes into the 
Monitor, it's a bug. Finished programs aren't supposed to do that 

A third way to get into the Monitor, but only on the Ilgs, is with a desk 
accessory called Diuersi-flack Interrupt any program with open-apple/ 
control/escape to get to the Ilgs desk accessory menu, choose Diversi- flack 
from the menu, and you are in the Monitor. The Ilgs Monitor's new Q(uit) 
command will take you back to the desk accessory menu; a quit from there 
will take you back to the program in progress. For more about Diversi-MacK 
see my introduction to this month's letters. 

Once you get into the Monitor, you'll find that its commands fall into four 
groups. There are commands for examining memory, commands for 
changing memory, commands for program control, and miscellaneous 
commands. 

Examining Memory. The values found in a computer's memory cells can 
represent just about anything, but most often they represent either numbers, 
ASCII characters, or machine language programs. The Ilgs Monitor gives you 
tools to examine RAM and ROM memory from each of these three perspectives. 
(The Monitor on older Apples doesn't include an ASCII display, but Open- 
Apple already solved that problem back on page 112. If you don't know RAM 
from ROM from registers, go back to the beginning of our second volume and 
try "The Magic of Peek and Poke," February 1986, pages 2.2-2.5.) 

To look at memory from the perspective of numbers, you enter the hex 
address that you want to see the contents of and press return. Successive 
returns display successive bytes of memory. To display a range of memory all 
at once, enter the beginning and ending addresses separated by a period. 

The Ilgs offers several enhancements to this system. First of all, the Ilgs 
displays the ASCII representation of each byte along with the numerical 
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value. If you are in 80-column mode, the Monitor will notice it and will display 
16 bytes on each line instead of the usual eight Finally, pressing control-X will 
terminate the display of a range of memory values. On older Apples, the only 
way to terminate a range display is to press control-reset Here is what the 80- 
column memory display looks like on the Ilgs: 

♦2000. 20FF 

00/2000:00 01 02 03 04 05 0G 07 08 09 0fl 08 0C 00 0E 0F- 

00/2010:10 11 12 13 14 15 IG 17 18 19 Ifl 18 1C ID IE IF- 

00/2020:20 21 22 23 24 25 2G 27 28 29 2R 28 2C 20 2E 2F- ( ]*+,-./ 

00/2030:30 31 32 33 34 35 3G 37 38 39 3fl 38 3C 30 3E 3F-012345G789: ;<=>? 

00/2040:40 41 42 43 44 45 4G 47 48 49 4fl 48 4C 40 4E 4F-eRBCDEFGHIJI<LMN0 

00/2050:50 51 52 53 54 55 5G 57 58 59 5R 58 5C 50 5E 5F-PqR5TUVWXYZ[\] 

00/20G0:G0 G1 G2 G3 G4 G5 GG G7 G8 G9 GR GB GC GO GE GF- 'abcdefghi jklmno 

00/2070:70 71 72 73 74 75 7G 77 78 79 7R 78 7C 70 7E 7F-pqrstuvuxyz{| }~. 

00/2080:80 81 82 83 84 85 8G 87 88 89 8R 88 8C 80 BE BF- 

00/2090:90 91 92 93 94 95 9G 97 98 99 9R 98 9C 90 9E 9F- 

00/20R0:fi0 R1 R2 R3 fi4 R5 RG R7 RB R9 fifi RB RC RD RE RF- ! ()*+,- ./ 

00/2080:80 81 82 83 84 85 BG 87 88 89 BR 88 BC 80 BE BF-012345G7B9: ;<=>? 

00/20C0:C0 Cl C2 C3 C4 C5 CG C7 CB C9 CR CB CC CD CE CF-eRBCDEFGHI JKLMNO 

00/2000:00 01 02 03 04 05 DG 07 08 09 DR 08 DC 00 DE DF-PQRSTUVWXYZ[\] 

00/20E0:E0 El E2 E3 E4 E5 EG E7 EB E9 ER EB EC ED EE EF- 'abcdefghi jklmno 

00/20F0:F0 FI F2 F3 F4 F5 FG F7 FB F9 FR FB FC FD FE FF-pqrstuvuxyz{ | 

The ASCII characters on the right side of the display represent the same 
sixteen characters that appear numerically in the midsection of the display. 
This example shows a range of memory that I purposefully filled with values 
from 0 to 255 so you could see the relationship between values and ASCII 
characters. Control-characters are displayed as periods. No distinction is 
made between high-value and low-value ASCII. 

The numbers on the left edge represent the memory address of the first of 
the sixteen bytes in each line. The 6502 microprocessor used on earlier 
Apples could accommodate only 65,536 discreet memory cells. Thus 
Monitor addresses on these Apples ran from $0000 to $FFFF. The micropro- 
cessor in the Ilgs, on the other hand, can accommodate 16,777,215 discreet 
memory cells. These are arranged as 256 "banks" of 65,536 cells each. The 
number in front of the slash indicates which bank you are looking at The 
number after the slash gives the address within that bank. 

To look at a different bank, you can enter a number such as 02/2000.20FF. 
This would display "page" $20 in bank $02. The addresses you give must 
both be within the same bank. 

L(ist). The third perspective for looking at memory is with the L(ist) 
command. Enter an address and "L" and you will see a "disassembly" of the 
section of memory that follows that address. Not all ranges of memory 
actually hold machine language programs. Some hold data, some hold 
programs in other languages, some hold nothing at all. The big limitation of 
the list command (a limitation it shares with other disassemblers) is that it 
can't tell real machine language code from other kinds of data. It "disassem- 
bles" everything, whether the results are meaningful or not 

The Ilgs list command is able to disassemble all the 65816 operation 
codes and addressing modes. For a complete description of these codes 
and modes see "A 65802/65816 pre-boot" and "Introduction to the 65802/ 
65816" in our August 1986 issue, pages 2.49-56. 

One big problem that occurs when a program tries to disassemble 65816 
machine code is that the "immediate mode" of three commonly-used 
instructions, LDA, LDX, and LDY, can be either two or three bytes long and the 
disassembler can't tell which. These commands load the microprocessor's 
A, X, or Y register. With immediate addressing, the data that is to be put into 
the register is embedded within the program immediately after the 
instruction byte. If the registers are set up for 8-bit data, these instructions 
are two bytes long (one instruction or operation-code byte and one data 
byte). If the registers are set up for 16-bit data, on the other hand, these 
instructions are three bytes long (two data bytes). But a disassembler can't 
tell which is which. For example, get into the Ilgs Monitor and try this: 

♦FF/0203L 

l=m l=x 1=LCBRNI< (0/1) 

FF/0203: R9 00 LOR «00 

FF/0205: 00 R2 BRK R2 

FF/0207: 00 05 BRK 05 

Those BRK instructions in the second and third lines don't look quite right 
Perhaps this section of code was written to be executed with 16-bit registers. 
To tell the disassembler that you'd like to see the code listed that way, enter 
0=m (16-bit A register) and 0=x (same for X and Y registers). Note that the 
format of these commands is backwards from what Applesoft programmers 
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would expect (0=m, not m=0), that "m" and "x" must be entered in lower 
case, and that the current list status of "m" and "x" is always displayed at the 
top of a listing. For example: 

♦0=m 0=x 0203L 

0=m 0=x 1=LCBRNK (0/1) 

FF/0203: R9 00 00 LOR «0000 

FF/020G: R2 00 00 LDX tt0500 

When you examine memory with the Monitor and you look at bank zero, 
you will always see the "language card" RAM in the address space from 
$0000 to $FFFF. If what you really want to see is the ROM that is normally 
found in this address space, look for it in bank $FF. That's what we've done 
here. (There's more ROM in bank $FE.) Note in the above examples that once 
you've set the bank to $FF (or whatever), it will stay there (with one exception 
to be noted later) until you change it again. 

Unlike the ROM code, the hardware softswitches and peripheral card 
firmware that appear in the address range from $C000 to $CFFF on earlier 
Apples appear there still on the Ilgs (but in banks $00, $01 $E0 and $E1 
only). Thus, two banks of $D000-$DFFF memory are needed to squeeze 64K 
of RAM into these banks. To control which bank you are looking at, enter 1=L 
to see the main bank (usually called bank 2 in the Apple literature) and 0=L 
to see the secondary bank (usually called bank 1). 

In addition to allowing you to examine sequential memory bytes as values, 
ASCII characters, and assembly language mnemonics, the Ilgs Monitor gives 
you the power to examine memory by searching for a specific byte pattern 
and by comparing two segments of memory for differences. 

Pfattern search). The first Apple II Monitor to have a search command 
was the one in the enhanced lie. On that machine you can search memory for 
any one-byte or two-byte value. The command's syntax is "YYXX<adr.adrS" 
where YYioC is two sequential bytes appearing as XX YY. Yes, they're 
backwards. 

The Ilgs search command is very different from the one in the enhanced 
lie. First of all, rather than being known as S(earch), as on the enhanced lie, it 
goes by P(attem search). Second, the values (or pattern) you are searching 
for can be up to 236 bytes long. Third, the pattern you are looking for must be 
surrounded by backslashes. Fourth, the pattern can include hexadecimal 
values, ASCII values, or "flipped" ASCII (flipped means backwards— "BOB" 
instead of "BOB," for example). Tfy this: 

♦\20 ED FD\<FF/FB00.FFFFp search Monitor code for JSR SFDED 

FF/F94C: 

FF/FD4R: 

FF/FDG4: 

FF/FDGC: 

FF/FF2F: 

FF/FF34: 

FF/FF37: 

*\"Rpple"\<FF/0000.FFFFp search bank $FF for "Rpple" 

FF/8B02: 

FF/B9R7: 

FF/C7G7: 

FF/F914: 

FF/FB09: 

When you search for ASCII characters as we did above, the search finds 
only high-value ASCII characters. However, the Ilgs Monitor has an "ASCII 
filter mask" that will modify the characters you specify to low-value ASCII or 
to other weird stuff. The filter mask goes by the name 'T' It can be set to 
anything from $00 to $FF with the =F command. $FF is its natural setting. $7F 
will get you low-value ASCII. The other 254 settings are of questionable value. 
'Tfythis: 

*7F=F 

*\"Rpple"\<FF/0000.FFFFp search bank $FF for "Rpple" 

FF/2R19: 

FF/912B: 

♦\'PDGO'\<B000.BFFFp search 00/B000 to BFFF for "OGOP" 

00/BB93: 

Notice a couple of things here. The search for "Apple" with the filter set to 
$7F turned up two more occurrences that the first search didn't catch. 
Likewise, none of the first search's hits turned up in the second search. This 
means the "ASCII filter mask" doesn't create "wildcard" bits. Instead, it 
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simply clears bits in the character pattern specified. Only exact matches with 
the new pattern will be found. Secondly notice that in the search for POQO 
backwards (the backwards part is specified by means of a single quote mark 
rather than a double quote mark) we didn't specify a bank address, but in all 
the other searches we did. This is because the llgs search command always 
defaults to bank zero unless you specify another bank. This is inconsistent 
with the other Monitor commands, which default to the last bank specified, 
and is the exception to the last-bank-specified default that was mentioned 
earlier. This is probably a bug, but maybe there's a good reason for it 1 haven't 
discovered yet 

V(erify). The command for comparing, or "verifying" two segments of 
memory hasn't changed from earlier Apple 11s, except that bank addresses 
can now be specified. If "adr" means an address of either the form "XXXX" or 
"XX/XXXX," then the format of this command is "adr<adr.adrV". The two 
segments of memory you are comparing can be in different banks, but 
neither segment can cross a bank. 

For example, load an image of Applesoft as found on the lie into a Ilgs at 
$2000. (More on how to actually do this later.) To compare this image to 
what's in the Ilgs, do this: 

♦00/2000<FF/D000.F7FFv 
FF/E00G:00 (3G] 

FF/F1FE:30 (50) 

FF/F233:D9 (09) 

FF/F234:FB (F2) 

FF/F3CB:20 (flD) 

FF/F3CC:3fl (79) 

FF/F3CD:F9 (C0) 

As you can see from the display, the two images are almost exactly the 
same. For a complete description of the differences between lie Applesoft 
and earlier versions, see "Up where Applesoft lives" in our June 1985 issue, 
pages 140-44. The primary difference is that lie Applesoft (and now 
Applesoft on the Ilgs) includes support for double-low-resolution graphics 
(80 pixels across the screen by 48 high). 

(The differences between lie Applesoft and Ilgs Applesoft are as follows: 
$E006 is a spare byte that has had various values in various versions of 
Applesoft— the zero in this byte on the Ilgs matches what the original 
Applesoft had. The next three changes fix a bug in the double-low mode that 
allowed the Y coordinate to be as large as 80 on PLOT and SCRTl commands, 
when 48 should have been the maximum. The last three changes were 
necessary because the softswitch for reading whether double-resolution 
graphics are turned on isn't in the same place on the lie and Ilgs. 
Mysteriously, a one-byte change necessary to fix a bug in the double-low 
SCRTi function, which was mentioned in our June 1985 article, wasn't done.) 

Modifying Memory. There are several ways you can use the Monitor in all 
models of Apple II to modify RAM memory. To change one byte, enter the 
address of the byte you want to change, a colon, and the new value. To change 
the bytes that follow the first, enter more values, but be sure to include a 
space between each. After you press return you can continue where you left 
off by simply entering a colon and more values. 

In addition to entering hexadecimal numbers, the lie, enhanced He, and 
Ilgs have what's called an "ASCII input mode." On the lie and enhanced He 
you can store the ASCI I code for a letter in memory by typing the letter with a 
single quote in front of it. If you want to enter several letters in a row, you must 
precede each with a single quote, like this: 

*2000: 'D 'r 'a 'g 'o 'n '' 's Ilc/enhanced lie fiSCII input mode 
*2000.2007 

2000- C4 F2 El E7 EF EE fi7 F3 

ASCII input mode on the Ilgs is much different Instead of preceding each 
letter with a single quote, you surround the letters with double quotes. The 
characters you enter are marched through the ASCII filter mask (mentioned 
earlier in the discussion of the search command) before being stored in 
memory— thus you can use the filter to obtain low-value ASCII. Only high- 
value ASCII is available on the He and enhanced He. Here are some 
examples: 

*07/100: "Dragon's" 

*100. 10F 

07/0100:C4 F2 El E7 EF EE fl7 F3 FF FF FF FF FF FF FF FF-Dragon's 

*110: 'Dragon"s' 

*110. IIF 

07/0110:F3 R2 EE EF FF FF FF FF FF FF FF FF FF FF FF FF-s"no 


7F=F 

*120: "Dragon's 
*120. 12F 

07/0120:44 72 G1 G7 GF GE 27 73 FF FF FF FF FF FF FF FF-Dragon's 

As you can see in the second example, a single quote is supposed to give 
you backward, or flipped, ASCII. However, it seems to work only with the last 
four characters you enter. That's a bug. In the third example, I changed the 
filter mask to get low-value ASCII, notice that you don't really need a closing 
quotation mark if you're at the end of a line. (In comparing the Ilgs with the 
He and He I just noticed another important Monitor difference— on the Ilgs 
the keyboard's delete key works, at last, at last) 

M(ove). The move command, which is available on all versions of the 
Monitor, provides another way to modify memory. The command syntax is 
"dest<adr.adrM" where "dest" is the destination address and the "adr.adr" 
range defines the segment of memory you want to move. On the Ilgs this 
command can move memory from bank to bank, but Just as with the verify 
command, it can't deal with ranges that cross a bank boundary. It's also 
important to make sure the destination area isn't inside the source area, or 
you may get results other than those you expected. 

Earlier I mentioned that I'd show you how to get an image of He Applesoft 
into the Ilgs, so that the two can be compared. You can't Just BSAVE 
HC.FP.IMAGEA$D000,L$2800 because while the BSAVE is going on ProDOS 
will be active. The snapshot you'll get will be of the ProDOS kernal rather than 
of Applesoft This can be bewildering. The solution is to either take the 
snapshot with DOS 3.3, or do this: 

*2000<D000.F7FFm move Applesoft's image to $2000 (do this on a lie) 

*3D0G 

] BSfiVE 1 1 C . FP . I MRGE , fi$2000 , L$2B00 

Z(ap). The Ilgs has a new command for filling a range of memory with a 
specific value. The syntax is "vaKadnadrZ", where val is a hex number. For 
example, 7<07/ OOOO.FFFFz will put a seven in every byte in bank seven, which 
is not necessarily a good thing to do. You can also zap memory on older 
Monitors, but it requires a trick. Try: 

* 2000:0 

*2001<2000.20FEM 

Because the destination address is inside the source address, the effect of 
this command will be to move the value at byte $2000 into every byte on that 
page. 

The Mini-Assembler. The final way to modify memory with the Monitor is 
to use the Mini-Assembler. The heritage of the Mini-Assembler goes back to 
the original Apple 11, where it could be found as part of Integer Basic. You can 
run the Integer Basic Mini-Assembler by entering the Monitor while Integer 
Basic is active and typing "F666Q". Because it uses "undocumented entry 
points," however, the Integer Basic Mini-Assembler doesn't work right on the 
He or Ilgs. On the enhanced Apple He, the 3.5 ROM He, and the Ilgs, you can 
start up newer versions of the Mini-Assembler directly from the Monitor, with 
or without Integer Basic, by entering an exclamation point 

The Mini-Assembler can be used to write short, uncomplicated assembly 
language programs. It's much easier to write longer programs on full-blown 
assemblers because they allow you to give names or "labels" to program 
segments and addresses, because they make it easy to insert new lines in 
what you've already written, and because they provide many other amenities 
that the Mini-Assembler doesn't AH the Mini-Assembler can do is allowyou to 
type in one assembly language mnemonic and operand at a time; it converts 
these into the equivalent machine language values and stores them in 
memory, nonetheless, it's a useful and handy tool to have around. 

It was possible to execute Monitor commands from within the original 
Mini-Assembler by starting a line with a dollar sign. This isn't possible with 
the Mini-Assemblers that start up with an exclamation point However, it's not 
necessary either because you can switch between the Mini-Assembler and 
the Monitor so easily on these machines (the exclamation point gets you in, 
return on a blank line gets you out). In addition, the Ilgs Mini-Assembler does 
allow you to directly enter hex or ASCII values into memory. 

Once you are in the Mini-Assembler, the first thing you must do is provide 
the address where you want your machine code to be placed. Follow that with 
a colon and an assembly language instruction. The allowable instructions, 
addressing modes, and addressing mode formats for the Mini-Assembler are 
shown in our August 1986 issue, page 2.52. The Ilgs Mini-Assembler can 
handle all of the 65816 instructions and addressing modes; the 3.5 1 Ic model 
can handle all 65C02 instructions; other models handle only the 6502 
instructions and modes. 
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Begin each line you enter after the first with a blank space if you want that 
line's machine code to follow the previous line's. On the llgs, a colon instead 
of a blank space tells the Mini-Assembler that hex data follows. A double 
quote mark instead of a blank indicates ASCII characters (which will be 
forced through the ASCII filter mentioned earlier). A number indicates you 
are giving a new address for storing machine code. Thus: 

* ! 

!2000:LDX tt0 


00/2000: R2 00 

LDX tt00 

load a zero into X register 

! LDR 200E,X 



00/2002: BD 0E 20 

LDR 200E,X 

load R with what's at $200E+X 

! BEQ 200D 



00/2005: F0 0G 

BEQ 200D {+0G} 

branch on equal--did R get a zero? 

! JSR FDED 



00/2007: 20 ED FD 

JSR FDED 

jump to the PRINT subroutine at $FDED 

! INX 



00/200R: EB 

INX 

increment X (X=X+1) 

! BNE 2002 



00/200B: D0 F5 

BNE 2002 {-0B} 

if X< >0, branch to get next character 

! RTS 



00/200D: G0 

RTS 

return to caller 

!"Read Open-Rpple 

every month for health 

and wealth. 


!:0 

How did 1 know while 1 was entering the second line that the ASCII string 
the routine prints would occur at $200E? 1 didn't This is the kind of thing a 
true assembler handles easily. In this case, it's necessary to guess at the 
correct address (in order to save space for the instruction), then go back and 
correct it after you have finished the program and know the correct address. 
It's also necessary to guess at and correct the destination of the branch in the 
third line of the program. Incidentally, the Mini-Assembler display you see on 
your screen is much cleaner than what's possible to show here— the output 
for each line overwrites the input Try it and see. 

Program control. Once you've entered the above program with the Mini- 
Assembler, press return on a blank line to get back inside the Monitor and try 
this: 

*2000g 

Read Open-fipple every month for health and wealth. 

The Q(o) command tells the Monitor to execute the subroutine at the 
address you give. $2000 is the temporary home of the Chinese fortune 
subroutine we just entered with the Mini-Assembler. 

An important, but often overlooked, aspect of the (Q)o command is that it 
loads the microprocessor's registers with specific values, which you can 
control, just before jumping to the subroutine at the address you specify. 
(Incidentally, it does JSR, not JMP, so if the routine you call ends with an RTS 
you'll return cleanly to the Monitor, as in the example here.) 

TVythis: 

*(press control-E and return) 

— display on II, II-Plus, He, lie, enhanced He 
fl=0B X=15 Y=25 P=30 S=F0 


---display on 3.5 lie 
f1=00 fl=0B X=15 Y=25 P=30 S=F0 


---display on Ilgs 

fl=000B X=0015 Y=0025 5=01F0 D=0000 P=30 B=00 l<=00 I1=0C 0=80 L=1 m=l x=l e=l 

Control-E displays the values that will be placed in the microprocessor's 
registers when control is passed to the address you specify with the Q(o) 
command. On the 3.5 lie and the Ilgs some of the displayed values aren't 
actually registers, but are "flags" that indicate which memory banks will be 
active when Q(o) is executed, as well as other stuff. You see this same display 
after the microprocessor hits a BRR instruction, as mentioned many 
paragraphs ago. Hot only is the display the same, so are the values. In other 
words, a BRR puts you into the Monitor and displays the values in the 
registers when the BRR occurred. The flags indicate the status of the machine 
at that time. G(o) returns to the program with those same values in the 
registers and that same machine status. 

You can, however, change the values from the Monitor if you like, so that 
Q(o) will use different values or flags. On all machines except the Ilgs you do 
this by pressing control-E and return to get the register display. Then enter a 


colon at the beginning of the next line followed by the value you want in the A 
register, the value you want in the X register, and so on. If you'd like to 
experiment with this, be aware that changing the P or S register to a random 
number sometimes locks the machine up so tight you need a can opener to 
get it back open. (To change the M register on the 3.5 lie use "44:val".) 

On the Ilgs, on the other hand, you change the values that will be placed in 
the registers by entering the new value you want, an equal sign, and a letter 
designating the register you want to change. We used this format earlier in 
our discussions of the L(ist) command and the ASCII filter. On the Ilgs you 
can also restore the registers and flags to a "normal" configuration by 
pressing control-R 

The program we entered earlier with the Mini-Assembler begins by loading 
theXregister with a zero. You can see whatwould happen with othervalues by 
changing the X register value with the Monitor and Q(o)ing to $2002. For 
example: 


---ail but Ilgs 

*(control-E return) 
(registers are displayed) 
*:00 05 
*2002G 


---Ilgs 

*(control-E return is optional on Ilgs) 
(registers are displayed) 

*5=X 

*2002G 


Open-Rpple every month for health and wealth. 

The A register is the microprocessor's accumulator, where all math 
operations are done. X and Y are the index registers. S is the stack register, 
which points a crooked finger at the current stack position. P is the 
microprocessor's status register. The meaning of its bits change slightly, 
depending on whether the microprocessor is in 6502 ("emulation") mode or 
65816 ("native") mode. Only the Ilgs has these two modes. The "e" flag tells 
you which mode the machine is in; 1=6502 mode, 0=65816 mode. Here's 
what the bits in the P register mean: 

Meaning of the P(rocessor status) register 

N V 1 B D I Z C e=l on Ilgs (G502 mode) and all other Rpple IIs 

N V M X 0 I Z C e=0 on Ilgs (G5B1S mode) only 

N is sign; l=negative 
V is overflow; l=true 
1 is unused 

M is R-register width; 1=B bits, 0=1G bits 
B is break flag; 1=BRI<, 0=hardware interrupt 
X is X-register width; 1=B bits, 0=1G bits 
D is binary coded decimal flag; l=true 
I is interrupt flag; l=interrupts disabled 
Z is zero flag; l=true 
C is carry flag; l=true 

The bits of the M register indicate the state of the machine's memory banks 
when a BRR occurred, or how you want the banks arranged for the next Q(o) 
command. Both the 3.5 lie and the Ilgs display an M register. Here's what the 
bits mean. 


Meaning of the M(emQry status) register 

00 P2 RD WR LC B1 B2 00 3.5 lie only 

RZ PX RD WR LX BX RR CX Ilgs only 

00 is unused 

RZ is alternate language card/zero-page/stack; l=active 
P2 is STOREB0/PRGE2 status; l=both active 
PX is PRGE2 status only; l=active 
RD is auxmem read status; l=active 
WR is auxmem write status; l=active 

LC is language card read status; l=card active 
LX is language card status; 1=R0M active 

B1 is language card bank 1 read status; l=active 
BX is overridden by L (see text); l=bank 2, 0=bank 1 
B2 is language card bank 2 read status; l=active 
RR is alternate ROM bank (see text); l=active 
00 is unused 

CX is alternate $C100-$CFFF ROM; l=active 

The meaning of the bits in the 3.5 lie's M register is similar to, but not 
exactly the same as, the M register on the Ilgs. In particular, the LC/LX bits, 
which indicate whether ROM or RAM is active in the $D000-$FFFF memory 
area, have exactly opposite meanings. On the 11c a one in that bit means RAM 
is active, on the Ilgs a one means ROM is active. The 11c uses two bits to 
indicate which language card bank is being used; if neither (if ROM is active), 
both bits are cleared to zero. The Ilgs uses just one bit for this (l=bank 2, 
0=bank 1), but changing that bit in the M register is a useless exercise — it's 
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always overridden by the L flag, which we looked at earlier in our discussion 
of the Uist) command. 

Both the 3.5 lie and the ligs have an alternate 16K RON bank that can be 
turned on with softswitches. Only the llgs has a bit in the M register to activate 
that ROM, however. On the llgs a program can obtain all of the information in 
the Monitor's M register, in exactly the same format, by reading byte $C068. 
Not only that, but by writing to the same byte (which is called the "state" 
register), a llgs program can change the machine's memory configuration. 
This provides Apple's programmers with a speedy way to save and restore the 
memory configuration of the llgs during an interrupt 

The control-R{estore registers) command in the llgs Monitor sets the M 
register to $08. A Q(o) with M=08 would turn on the lower 48K of the main 64K 
bank of RAM and put the Applesoft/Monitor ROM in the $D000-$FFFF area. 

The Q register (for "quagmire," according to the llgs documentation) that 
appears in the llgs memory display combines information from two other 
llgs hardware registers. These are the "shadow" register at $C035 and the 
"configuration" register at $C036. 

On the llgs, what you see on your screen is always a reflection of 
information stored in RAM memory banks $E0 and $E1 (On other Apples the 
active video area is in banks $00 and $01) Since Apple 11 programs written 
before the llgs appeared don't know bank $E1 from Capitol Federal Savings 
and Loan, the llgs hardware automatically "shadows" anything that is written 
into certain parts of banks $00 and $01 into the same parts of banks $E0 and 
$E1 It's as if you were able to deposit a dollar into First National and have 
your sugar daddy make a matching deposit into E-First National for you. 

There may be situations, however, when you wouldn't want a matching 
deposit made. For example, if your program is using the high-resolution 
graphics page 1 memory area ($2000-$3FFF) for data instead of pictures, 
there may be no reason to have the data shadowed into E0/2000-3FFF as 
well. With shadowing on, anything previously stored in the $2000-3FFF area 
of bank $E0 would be destroyed by writes to 00/2000-3FFF. Shadowing also 
slows down the llgs slightly. Under ProDOS 16, shadowing is normally turned 
off and video display manipulations are made directly to banks $E0 and $E1 
Under ProDOS 8, DOS 3.3, and Pascal, shadowing is normally turned on. 

Most of the bits in Q come from the shadow register. Only one, the one that 
indicates machine speed, comes from the configuration register. Here's the 
meaning of the bits in the quagmire register: 

Meaning of the 0{uagfnire] register 
SP LM 00 fix 5H H2 HI T1 

5P is processor speed; l=high, 0=nornial 

LM is linear memory; l=no l/D space at $C000 in banks $00 and $01 
00 is unused, must be zero 

fix is auxmem hi-res override; l=no hi-res auxmem shadowing 
5H is super hi-res (E1/2000-9FFF) ; l=no shadowing 
H2 is main/aux hi-res page 2; l=no shadowing 
HI is main/aux hi-res page 1; l=no shadowing 
T1 is main/aux text page 1; l=no shadowing 

Control-R sets the Q register to either $00 or $80. The speed is left as it was 
before the control-R 

Notice that it is possible, by manipulating the LM bit on the llgs, to disable 
the language cards and the $C000-CFFF hardware in banks $00 and $01 If 
you did this, the RAM in banks $00 and $01 would become continuous — the 
primary language card bank (bank 2) would appear in the $C000 area and 
the secondary bank would be at $D000. The $C000 hardware would appear 
only in banks $E0 and $E1 However, this isn't a practical alternative because 
llgs interrupts use some machine language code that lives in the $C000- 
CFFF ROM in bank zero. Interrupts cease to work when you invoke the linear 
memory option. 

The other three registers shown in the llgs register display are the direct 
register (D), the data bank register (B), and the program bank register (K). For 
more information on these registers, which are active only when the 
microprocessor operates in 65816 mode, see the August 1986 Open-Apple. 

X(ecute), R(esume), S(tep), and T(race). On the llgs, the Q(o) 
command can only be used to execute a routine in bank $00. If the routine 
you want to start lies elsewhere, use the X(ecute) command. This command 
expects the routine to end with an RTL (return from subroutine, long), 
however. Like X(ecute), R(esume) will also start up code in any bank. However, 
it JMLs (jumps long) rather than JSLing (jump to subroutine, long). Use it to 
continue program execution after a BRK. Q(o) and X(ecute) don't work well 
after a BRK— they mess up the stack with their own JSR/JSL. 

S(tep) and T(race) are available only in the original Apple 11 Monitor and in 
the 3.5 11c Monitor. (Hooks were left in the llgs for implementing these 


commands— they print "Step" and "Trace" on your screen at the moment) 
S(tep) lets you execute machine language programs one instruction at a 
time. As each instruction is executed, it and the contents of the registers are 
displayed on the screen. 2000S, for example, would begin stepping through 
a program living at byte $2000. To execute the next instruction, simply press 
S and return. 

T(race) is similar to S(tep) except that it doesn't stop after each instruction. 
To exit T(race) on the 3.5 11c, press solid-apple. To slow it down to one step 
per second, press and hold down on open-apple. Neither S(tep) nor T(race) 
works with programs that use the same zero page locations as the Monitor 
itself. 

Miscellaneous Monitor commands. There are a large number of 
miscellaneous Monitor commands that 1 should zip through for you. Some 
of them, such as l(nverse), N(ormal), val+val, and val-val, have been around 
since the original Apple 11 and are still available on the llgs. Others, such as 
W(rite) to and R(ead) from cassette tape, have mercifully disappeared on 
newer machines. 

In the same class with l(nverse) and N(ormal) is the control-Y user 
command. The control-Y command and the use of N as a command 
separator (much as the colon in used in Applesoft) were discussed at length 
in the February and March 1985 Open-Apples, Until the llgs, the + and - 
Monitor commands were of little value because only one-byte answers were 
displayed. The llgs, on the other hand, can take four-byte operands and 
display four-byte answers. The llgs also has a multiply instruction (valVal) 
that displays eight-byte answers. As before, all of these work with hexadecimal 
numbers only (where 8+8=10). 

While the DOS commands IN^ and PR# are the correct way to turn on input 
devices and printers, even from within the Monitor, the older Monitor 
commands control-R(eyboard) and control-P(rinter) have been retained. (For 
some reason, Basic.system commands don't work as well from inside the 
llgs Monitor as they do on earlier Monitors.) Likewise, 3D0Q (or Q(uit) on the 
llgs) usually works better for returning to Applesoft than control-C or control- 
B, but those commands have been retained as well. 

The rest of the miscellaneous commands are new to the llgs. There are two 
commands for converting numbers from hex to decimal and back again. To 
convert to decimal, enter the hex number followed by a equal sign. To convert 
to hex, enter an equal sign followed by a hex number, like so: 

*FF= 

Decimal-> 255 {+255} 

*=255 

Hbx -> $000000FF 

Control-T changes the current screen display to text page 1 if you somehow 
aash into the Monitor while viewing a graphics page. Control-^ (control-shift- 
6) allows you to change the cursor character, vifiiatever character you enter 
after control-^ will become a flashing cursor, 'fry it This also works in 
Applesoft on the llgs. 

=T is a llgs Monitor command that was mentioned in last month's letters 
section. It prints the current time on your screen. It has a related command, 
=T=, which allows you to reset the llgs clock. 1 recommend using the control 
panel instead. 

Finally, the llgs has a "tool locator" command. This command can be used 
to enter toolbox calls. It begins with a backslash, followed by a number that 
indicates how may bytes worth of input are needed by the tool, followed by a 
number that indicates how may bytes of output the tool will return, followed 
by the input bytes, followed by the two-byte tool number, another backslash, 
and a U. 

Here are two examples of the U command that call the ReadTimeHex and 
ReadASCIITime tools discussed last month ("Time to look in the toolbox," 
pages 3.21-22.): 

*\0 8 D 3\U (no inputs, 8 bytes of output, tool $0003] 

Tool error-> 0000 
00 00 IG 57 0E 03 84 04 

*\4 0 0 0 20 0 F 3\U 2000. 201F (4 in, none out, $00002000, tool $0F03) 

Tool error-> 0000 

00/2000:fi0 84 fiF 81 85 fiF 88 87 fi0 81 80 8fi 80 83 8fi 82- 4/15/87 10:03:2 
00/2010 :fi0 00 CO 00 00 00 00 00 00 00 00 00 00 00 00 00-G PM 

This call always returns a "tool error," however, if the error number is zero, 
no error occurred. 

That's the final verse in the new llgs Monitor. It's becoming a very long song. 
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Ladies and gentlemen, start your pencils. On page 
5.22 of last month's newsletter, in the middle column, 
the "AD" after the "00/030A:" should be an "A2:' 

In regard to last month's letter "All chips not off 
same block," several subscribers have written in that 
Ilgs memory cards require a type of 2561^ RAM chip 
called CAS before RAS. However, apparently not all 
Ilgs cards require this kind of chip. If you need chips 
for a Ilgs, I suggest you call or write Microprocessors 
Unlimited (24000 S Peoria Ave, Beggs, OR 74421 
918-267-4961). They sell bulk RAM chips at good 
prices, provide fast service, send you excellent chip 
installation instructions, and are keeping track of 
what chips work in which Ilgs cards. 

In my answer to last month's letter "Odd bank 
out," I asked for help on calling the Ilgs memory 
manager with the Mini-Assembler. I've gotten some 
good help on that one— you'll read all about it next 
month. One of the people who responded was Bill 
Basham of Diversi DOS fame. Basham has already 
developed three programs for the Ilgs that are the 
most exciting Ilgs packages I've seen to date. Fiot 
because of stunning graphics or sound, mind you, 
but because of the way they use the memory 
manager. Diversi-Cache ($55) speeds up Apple 5.5 
drives (not UniDisks) by storing the tracks most 
recently accessed in RAM. Diversi Key ($45) is a 
memory-resident keyboard macro program that 
hides itself inside the Ilgs and provides macros for 
all your programs. You have to see this one to 
believe it. It has lots of bells and whistles, too. With 
either of the above programs you also get Diversi- 
Hack, the wonderful little desk accessory mentioned 
in this month's lead article that lets you get into the 
Monitor from the midst of anywhere. These programs 
work oniy on the Ilgs, of course, and require 512R. 
(Diversified Software Research, 54880 Bunker Mill, 
Farmington, Ml 48018-2728 515-555-9460). 

Slot 3 RAMdisk rules 

Why does Apple Writer 2.0 disconnect RAMdisks in 
slot 3? Can this be changed? My RAMWorks card 
would be useful as a RAMdisk if Apple Writer would 
stop disconnecting it. 

Jerry Hill 
FPO Seattle, Wash. 

You raise an extremely interesting question. Apple's 
"ProDOS Technical Mote ^8" specifies an exact 
protocol that programs are supposed to use to 
determine whether a disk device in slot 5 should be 
disconnected or not. This information is also included 
in the Addison-Wesley edition of the FroDOS Tech- 
nical Reference Manual (pages 90-91). 

Programs that use both 64R banks of memory, 
such as Apple U/riter 2,0, have to disconnect the 
ProDOS slot 5 RAMdisk because it also uses the 


auxiliary 64R bank. If both were active at the same 
time each would overwrite the other and chaos 
would reign. 

However, many other RAMdisks, such as the one 
that came with your auxslot RAM card, either don't 
use the 64R extended memory area or can be 
configured not to use it. Since these RAMdisks don't 
interfere with 128R programs, there is no reason 
128R software should disconnect them. Tech Mote 
^8 has specified since late 1984 what RAMdisk 
developers and what 128R program developers 
need to do to avoid needless disconnection of slot 5 
RAMdisks. 



In the beginning, Apple's own software followed 
the Tech Mote ^8 protocol— AppleWorks 12 follows 
it exactly. But then something happened. Ren Rash- 
marek, who recently sent me a ton of information on 
this issue (much of which I'm using here), thinks that 
the key event was Apple releasing its own memory 
card. In order to keep Apple software from working 
with third-party memory cards, Apple stopped fol- 
lowing its own Tech Mote, Rashmarek surmises. 

According to the Tech Tfote ^8 protocol, 128R 
software is supposed to look through the ProDOS 
global-page device list at $BF52-$BF5Pand disconnect 
only those devices that are connected to slot 5, drive 
2 and that have the low two bits of their device 
number set. This translates into units with device 
numbers of$BF, $BB, $B7, and $B5. The key instruc- 
tions that accomplish this feat load the device list 
entries one-by-one, AMD each with ^$F5, CMP each 
to ^$B5, and branch to disconnect devices that come 
up "equal." 

However, Apple lVnter2,0 and later, AppleWorks 
15 and later, and Instant Pascal have two bytes of 
this protocol changed. All of these products AMD 
with #$70 and CMP with #$50. This has the effect of 
disconnecting any slot 5 disk device, whether 
assigned as drive 1 or drive 2, whether RAMdisk, 
hard disk, or Apple's own disk. 

There are two ways to fix the problem. One is to 
search through programs that disconnect slot 5 
RAMdisks looking for the byte string B9 52 BF 29 70 
C9 50. Change the 70 back to F5 and the 50 back to 
B5. This will make the program follow Apple's 
published protocol and your RAMdisk will no longer 
be disconnected. 

Another way to avoid the problem is to not assign 
disk devices to slot 5. Both Applied Engineering and 
Checkmate Technology have updated their RAMdisk 
software so that their RAMdisks can appear to be in 
slot 2. 

So, why do Apple Writer, AppleWorks, and Instant 
Pascal disconnect third-party RAMdisks in slot 5? 
Does a Fortune 500 company with $800 million in 
the bank really disregard its own software protocols 
just to give its RAM card a competitive edge over 
those from third-party developers? I personally 
believe the sincerity of Sculley, Yocam, and Gassee 
when they say that they realize the importance of 
third-party developers to Apple's success. However, 
they can't be expected to go over every byte of code 
in Apple software. And it doesn't take much imagina- 
tion to picture some low-level product manager 
being more concerned about achieving sales goals 
than about Sculley's third-party philosophy. 


Apple's officers need to let the public and its 
employees know, by actions not words, where they 
stand. Why doesn't Apple's software follow Apple's 
own protocols? Lots of people would like to know. 

You wanna see a syntax error? 

Is there any software that translates what you write 
in American English to Mexican Spanish? If so, please 
let me know, I need to constantly get memos, etc., 
translated. 

Don Robinson 
Coronado, CA 

Dennis replies: The question you ask seems rea- 
sonable; translation seems to be no more difficult 
than looking up words in a dictionary and arranging 
them into a sentence in the new language. In truth, it 
is a lot more complex than that; there are verb forms, 
context, and syntax (among other things) to consider 
in making the translation. In fact, just translating 
English into something a computer can understand 
is difficult enough, to say nothing of then getting the 
computer to express what it understood in Spanish. 

In order to communicate with computers nowadays, 
we humans have to learn languages such as Applesoft 
or Pascal, which have very limited vocabularies and 
very rigid sets of usage rules. In a word, our answer 
to your question is "no," at least for now, but the 
issue as to whether such a program will ever be 
available is interesting. 

TYanslating human language falls into a realm of 
computer research called artificial intelligence, or 
"AI." Several excellent books have been written that 
debate whether computers wilt ever be able to 
handle such complicated tasks. One that argues 
against the ability of a computer to simulate human 
responses is Computer Power and Human Reason, 
by Joseph Weizenbaum (W. H. Freeman). Weizenbaum 
is a pioneer in AI research and was originator of the 
computer game Eliza, which provides psychiatrist- 
like responses to statements entered by a human at 
the keyboard. 

Another book, which argues against Weizenbaum's 
dismissal of the practicality of AI research, is Gddel, 
Escher, Bach by Douglas Hofstadter (Vintage Books). 
Hofstadter leads us through a difficult but enlightening 
process of attempting to prove that a computer is 
capable of at least simulating human intelligence. 
Anyone seriously interested in natural language 
processing or other AI topics may want to seek out 
these books, as well as Artificial Intelligence, by 
Patrick Henry Winston (Addison-Wesley), and follow 
their bibliographies to further references. 

The computer language of the AI community is 
called LISP. A full AI version of LISP requires a lot of 
computer power. LISP, by Patrick Henry Winston and 
Berthold Rlaus Paul Horn (Addison-Wesley), is a very 
readable text about the subject. Logo, which at least 
some of our readers (and more of their children) are 
familiar with, was derived from LISP. 

natural language translation is similar in some 
ways to the command interpretation done by adven- 
ture games such as Zork. Zork's interpreter was 
originally implemented on a Digital Equipment Corp 
minicomputer using a LISP-like language called 
MDL, which was then "crunched down" to fit into 
micros for the commercial versions of the game. For 
some insight into the design of the interpreter, see 
"How to Fit a Large Program Into a Small Machine," 
Creative Computing July 1980, pages 80-87. For 
additional articles on the design of adventure games 
that seem to interact with their human players, see 
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the rest of that issue of Creative Computing and the 
December 1980 issue of Byte. 

Readers who are interested in this kind of stuff 
might like to investigate Polarware's adventure- 
game interpreter for the Apple II, which is called 
Comprehend. The cost is $95 from Polarware, Box 
3U Geneva, IL 60154 800-323-0884. 

CALL -875 

I have a program that was written for my old II-Plus 
and it worked fine— now I have a new Ilgs and the 
program sends me strange machine language screen 
entries. The program includes both a CALL -875 and a 
CALL -868 and my guess is that one or the other is 
causing this. Is this correct? If so, are any of the old 
calls still valid? Bob Schmidt 

District Heights, Md 

CALL -875 (clear current screen line) has not been 
valid since the introduction of the He. Those of you 
skipping from a II-Plus to a Ilgs may have some 
catching up to do. CALL -875 on the II-Plus jumps 
into the middle of the screen scroll functions to clear 
the current line. Apple changed these routines when 
rewritingthe monitor ROM for the He. Onthellgs, the 
code that replaces these routines generates the 
strange messages you've been seeing. 

CALL -868 (clear to end of line) is still valid. To clear 
the entire line (entirely from Applesoft) without 
moving the cursor and with the 80 <olumn firmware 
off, try the sequence: 

10 CH = PEEK(3G): POKE 3G,0: CALL -BGB: POKE 3G, CH 

With the 80-column firmware on, on the other 
hand, the correct way to clear the current line is to 
print a control-Z (CtIR$(26)) to the screen (control-L, 
CIIR$(12), will clear the whole screen; control-K, 
CIiR$(ll), will clear from the cursor to the end of the 
screen; and control-), CtiR$(29), will clear from the 
cursor to the end of the current line). That technique 
is better, for compatibility reasons, than calling a 
Monitor routine. Too bad it doesn't work with the 80- 
column firmware off. 

Apple has published several (slightly different) 
lists of Monitor addresses that it promises not to 
change on future Apple models. Any CALL not on one 
of these lists should be removed from your programs. 
The version of the list that's my current personal 
favorite is in the Apple lie Technical Reference 
Manual (3.5 ROM version) on pages 313-314. 

The great Tinaja Quest 

Who orwhat is "tinaja questing"? ^ gi 3 ^Qp 

Kingston, OnL 

Don Lancaster often offers a "tinaja quest for two, 
F.O.B. Thatcher, Arizona" as the grand prize in the 
contests he devises for his "Ask the Guru" column in 
Computer Shopper ($21/yr, 407 S Washington, 
Titusville, FL 32796 305-269-3211). I always figured 
it was something like a snipe hunt, but Dennis called 
Lancaster's Apple H Hotline number (602-428-4073) 
and asked. Lancaster said he uses the phrase to get 
people to call up and ask questions. 

Then he said that "timya" is a name for natural 
basins found in deserts in the Southwest U.S. (usually 
these basins are private and remote; their name 
comes from the Spanish word for a large earthen 
vessel). Like an oasis, a tinqja may be the only 
source of water and respite in a desert, so "timya 
questing" can be a life and death matter as well as a 
pleasant recreational pursuit. 
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While he had Lancaster on the line, Dennis asked if 
there was any way to fix the Apple Writer "load file 
to screen" function so that it always used the 
backslash rather than the current underline character 
(see Piovember 1986, page 2. 77c and February 1987, 
page 3.2). Lancaster said the complete details were 
in his Apple Writer Cookbook and his May 1987 
Computer Shopper column (page 244), but the 
essential details were—bload AMD.5YS at $2000 
and then, for version 2.0, 396E:C9 5C FA; for version 
2.1 3974:C9 5C EA. And if you'd like to make Apple 
Writer print through a Ilgs serial port, make these 
patches at the same time — for version 2.0, 4DB0:60, 
4F67:10, 4F6E:13; for version 2.1 4DC7:60, 4F7E:10, 
4F85:13 (from Lancaster's March 1987 Computer 
Shopper column, page 108). For the complete how, 
why, and wherefore of these patches, give Lancaster 
ajingle. 

APDA erratic on way up 

Immediately after reading your September 1986 
issue I sent $20 to the Apple Programmers and 
Developers Association and asked to become a 
member. In December I called their office and as a 
result received a receipt for my $20 and a promise 
that I would soon receive a membership agreement 
form. In January I called their office and as a result 
received three membership forms. I promptly signed 
one and sent it right back. It is now March, and I still 
don't if I am a member or not 

Joining APDA seems about as difficult as getting 
technical information out of Apple. Am I doing 
something wrong? Is anyone else experiencing this 
same kind of difficulty? Chuck Zamzow 

Battle Creek, Mich. 

APDA is alive and well and catching up with itself 
You're not the only one who has had a difficult time 
Joining, but APDA assures us you're a member. APDA 
grew from no members at all in August to 7,000 by 
the first of the year to 1X000 currently (and still 
growing). It took awhile for APDA to gear up to the 
demand. A large backlog developed in December 
and January because of members signing up at the 
end of 1986 to take advantage of a free book offer. 
The backlog was finally cleaned up in February as 
staff was added. Shipments have been up to speed 
since then, according to our colleagues at APDA. 

Programs, programmers wanted 

Softdisk is constantly looking for short Apple 11 
programs of all kinds for publication. In addition, we 
expect an opening around May 1 for a programmer- 
writer with extensive Apple technical background and 
capability of learning C-64 and IBM-PC. 

Val J. Golding, Editor-in-Chief 
Magazines on Disk 
4023 Greenwood Road 
Shreveport, LA 71109 

We get several requests a year for information on 
the "best way" for programmers to get their software 
published. There are many ways, which range from 
starting your own software publishing company to 
donating your work to your local user group's public 
domain library. In between are a number of outlets 
that are often overlooked, such as Softdisk, Uptime 
(Box 299, fiewport, RI 02840), thelSite OwlJoumal 
(5734 Lamar, Mission, RS 66202), and the Apple H 
magazines that print program listings. 

Most people don't realize that the major cost 
involved with publishing software is marketing. 


Salespeople, advertising, and dealer discounts are 
incredibly expensive. If you decide to start your own 
company you'd better either have deep pockets or 
an inexpensive marketing scheme. 

One such scheme, which has been very successful 
with a few software packages, is "shareware." Under 
this system, you encourage users to make copies of 
your disk and to distribute them to their friends. 
However, by means of a screen that appears when 
the program is started, you ask people who actually 
use your product to send you a payment for the 
program. The first product to be successfully distrib- 
uted this way in the Apple H world was Bill Basham's 
Diversi'DOS. Basham recently told us that about 25 
per cent of his Diversi-DOS income comes from 
shareware sales. 

Recently a number of shareware authors Joined 
together in a "programming cooperative" to get 
more bang from their marketing efforts. The group is 
called Living Legends Software (1915 Froude Street, 
San Diego, CA 92107 6191222-3722). 

Another route is to sell your software to an estab- 
lished software publishing house and collect royalties 
on sales. Or maybe you'd like to do contract pro- 
gramming for an established house — Roger Wagner 
Fublishing (P.O. Box 582, Santee, CA 92071), for 
example, is even now looking for some help from 
people who own a Ilgs and know assembly language. 

Pascal RAMdisk loader II 

1 read with interest the letter (February 1987, page 
3.5) from Keith Bernstein regarding a RAMdisk loader 
for Apple Pascal 13. Here's an alternative method to 
load startup files onto the RAM disk from a 3.5 inch 
disk. 

First, format your RAMdisk using FORMATTER 
version 13 (the Pascal formatter in the ProDOS 
System Utilities will not work) and transfer all the files 
you want into the RAM disk manually. 

Then use the T)ransfer command saying 
RAM5:,MYDISK:PASCAL.BACK. The Filer will respond 
with "Transfer xyz blocks?" Press "H" and specify the 
number of blocks that your data occupies on the disk; 
this is found at the bottom of a catalog listing. If you 
select the default size instead, the full volume, which 
is mostly empty space, will be transferred. That's 
rather wasteful. 

To use this file, boot up Pascal as usual, then 
T)ransfer MYDISK;PASCAL.BACK,RAM5:. The Hler will 
respond with "Remove all files from RAM5:?" After 
pressing "Y" the RAMdisk will be loaded. You can then 
press control-reset to boot up from the RAMdisk. Of 
course, all this can be done from an Exec program 
such as the one Bernstein wrote about in his letter. 

Incidentally, you may be shocked to learn that here 
in Australia the Ilgs retails for around $A3990 and the 
He retrofit for about $A1200. 

Daryl Cheshire 
Edithvale, Vic 

Dennis tried this and says it gives Pascal the same 
systematic RAMdisk startup/shutdown procedures 
we described for other operating systems in December 
1986 ("RAM Van Lines," page 2.87). To conserve 
space, Dennis suggests the RAMdisk should be 
Fjrunched with the Filer before determining it's 
block size and saving out it's contents. And, as you 
point out, this technique wipes out any files already 
on the RAMdisk when a "restore" is done. 

The prices you quote are about $2850 and $850 in 
U.S. dollars. If your import taxes on goods from 
Singapore (where the Ilgs is manufactured) aren't 
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any higher than those in the U.S., the difference must 
be freight (Seriously, Apple is doing a magnificent 
job— for a U.S. company— in developing products 
for a world-wide market Are you sure at least part of 
the difference isn't Australian taxes? 'There's no other 
legitimate reason for that large a price difference — it 
Just encourages black market transactions.) 

stop double RAM load 

Alan Bird's "Don't pass go" program for AppleWorks 
(liovember 1986, page 2.75 and December 1986, 
page 2.84) has been most helpful, but 1 have run into 
a bit of a snag with AppleWorks 2.0. This version 
automatically loads itself into fWl at startup. Since 1 
usually already have the program on my RAMdisk, 
there's no reason to load it again. Do you know how to 
keep it from doing that without having to press the 
escape key? 

Harlan R. Davis 
Bolingbrook, 111. 


Dry this: 

10 REM *** Don't Pass Go for RflMdisk ♦** 

20 TEXT : HOME : VTfiB 10 
25 D$=CHR$(4) : F$="fiPLW0RI<S. SYSTEM" 

30 PRINT D$;"BLafiD";F$;",R$2000,TSYS" 

40 IF PEEK (8250] < > 57 THEN PRINT 

"Program requires fippleUorks 2.0." : END 
45 PRINT "Patching fippleWorks" 


Qpen'vlppte 
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50 POKE 144GB, 44 : REM no space bar 

G0 POKE 14148,208 

G1 POKE 14149,19 : REM no return for date 

70 FOR fiDR=13271 TO 13273 

71 : POKE fiDR,234 

72 NEXT : REM no RRMdisk preload 

100 PRINT D$;"BSfiVE";F$;",fl$2000,T5YS" 

Blink and it’s gone 

1 use a C-Vue IXD screen a lot Its like eating tofu — 
you eventually develop a taste for low contrast But 
the "insert" cursor in AppleWorks (the blinking 
underline) is impossible to find. The "replace" cursor 
never gets lost Most of the time 1 use insert mode. Is it 
possible to patch AppleWorks so that the insert mode 
cursor is a blinking inverse block? 

Tom Meyer 
Highlands, HC 

To replace the underline character with a new 
value, use: 

BLORD RPLWORKS . SYSTEM , R$2000 , T5Y5 

CRLL -151 

<addr>:<ual> 

3D0G 

BSRVE RPLWORKS . SYSTEM , R$2000 , TSYS 

where <addr> is 2D80 for version 12, 2D8B for 
version 13, or2DAl for version 2.0, and<vat> is the 
ASCII value you want for your cursor (DF gives the 
underline). We tested this patch using "FF' for the 
value, which gives a flashing checkerboard box for 
the insert cursor, and using "20," which gives an 
inverse box. / think you'll be able to see 20 better, but 
you may have trouble distinguishing it from the 
replace cursor— the only difference will be that the 
insert cursor blinks faster. The value for the replace 
cursor itself is generated by code that also appears 
to initialize other routines; we decided not to mess 
with it. 

AppleWorks reset 

Please give us a patch for AppleWorks that makes 
reset work when AppleWorks hangs. I'm looking for a 
more general solution than those you mentioned at 
the end of your answer to "Insert system disk and . . . " 
in April (page 3.18)— something that would work 
without MacroWorks or with PinPoint, etc. There must 
be a warm start address in AppleWorks somewhere! 

Thom Ryan 
Toronto, Ont 

Back in June 1986, page 2.33, we published "An 
AppleWorks Rescue Routine" that works with all 
AppleWorks versions prior to 2.0. It has the advantage 
of being useful after AppleWorks hangs. The other 
techniques we mentioned in June involve your 
doing something special before AppleWorks hangs 
so that you'll be able to recover. Here's an instant 
replay of the June 1986 routine, along with some 
new information on how to make it work with 
AppleWorks 2.0: 

Press control-reset to get into the Monitor. 

(If you can't get to the Monitor, go to jail.) 
*C073:0 

*3 control-P return 

(If this doesn't get you B0-columns, go to Jail.) 
*2F0:2C B3 C0 2C 83 C0 4C 
*:33 10 <--for RppleWorks 1.1 through 1.3 
*:27 11 <--for RppleWorks 2.0 
*2F0G 


If the main menu appears messed up, just press 
escape. Save any files you have on the desktop and 
reboot after using this technique. 

More mail merge categories 

There is a peculiarity to the mail merge function of 
Appleworks 10 people should know about 1 couldn't 
understand why some of the categories from my 
database were not being picked up and inserted, as 
specified, in my form letter. 1 then began to wonder 
about the fact that the mail merge data must be 
printed to the clipboard using a tables-style report 
That report format has a default platen width of 8 
inches. Sure enough, changing the platen width to 
something greater (e.g., 17 inches) allowed all of my 
categories to be printed to the clipboard. Changing 
the characters per inch to 17 can accomplish the 
same thing. 

1 hope that this will save someone a headache or 

William J. Linville 
Terre Haute, Ind. 


Telephone feedback 

1 want to thank Jim Hercules for his inspired 
AppleWorks phone dialer (April 1987, page 318). 
Because of his discovery that you can set up a 
modem as a printer in AppleWorks, 1 now have an 
incredibly fast and easy to use phone dialer. But 
mine's in a spreadsheet file. Row 1 is a name. Row 2 is 
that name's phone number, including 1 and area 
code if needed; Row 3 is the next name. Row 4 that 
person's phone number, and so on. 1 start the phone 
number with a " to make it a label so 1 can include 
commas for pauses and dashes for readability. 1 can 
open-apple-F(ind) the name 1 want to dial, use the 
down arrow key to highlight the number below the 
name, then print that row to the modem. 1 can scroll 
back and forth through my phone list, insert, delete, 
or make changes. Hercules' suggestion is one of 
those outstandingly useful tips that I've come to 
expect from Open-Apple and its readers. 

Thanks also to Tony Bond (page 3.20) for the 
suggestion to copy an AppleWorks 13 SEQ.PR file 
onto an AppleWorks 2.0 disk in order to get control-® 
entered as a printer command. This seems to work 
fine, but if you're using Applied Engineering's Apple- 
Works 2 Expander, you'll have to reinstall it (it uses the 
SEQ.PR file for information of its own). That means 
reinstalling Super MacroWorks, too. 

1 have a suggestion for Jim Thornburg's problems 
with using date categories in his AppleWorks genealogy 
data base. AppleWorks' two-digit year Just doesn't 
make it in genealogy, but dates can be effectively 
manipulated manually for some very useful reports. 
Enter birth dates in three categories: Birth-Year 
(1860), Birth-Month (02), and Birth-Day (29). Do the 
same with death dates. A chronological sort of all 
records by birth date is easily accomplished using 
multiple sorts— sort days first, then months, then 
years. You can also print reports with calculated 
categories that subtract Birth-Year from Death-Year 
and Birth-Month from Death-Month to give approximate 
age at death. 

Another option is to enter dates in a single category 
in the following format 1875-07-22. This format sorts 
nicely alphabetically in forward or reverse order. So 
far I've found no need for AppleWorks' automatic date 
feature in my genealogy data base, despite its useful- 
ness in other situations. 

C. L. Roberts 
Lafayette, Calif. 



